home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
AOL File Library: 3,701 to 3,800
/
aol-file-protocol-4400-3701-to-3800.zip
/
AOLDLs
/
Other Special Interests
/
PEDIGREE_ V3.08 Breed Tracker
/
PED308.exe
/
PEDIGREE.DOC
< prev
next >
Wrap
Text File
|
1995-04-11
|
104KB
|
3,016 lines
/- PEDIGREE
PEDIGREE ---|
\- PEDIGREE
Version 3.08
(C) 1988-1995 By Charles H. Orange
P.O. Box 20
Downers Grove, Ill. 60515
INTRODUCTION ....................................... 1
OVERVIEW ........................................... 2
GETTING STARTED .................................... 3
System Requirements .............................. 3
Program Installation ............................. 3
RUNNING PEDIGREE ................................... 7
Accessing The Help System ........................ 7
Conventions For Input ............................ 7
Mouse Usage .................................... 7
Selecting Menu Items ........................... 7
Keyboard Entry Editing ......................... 8
Input Fields ..................................... 8
AKC Number ..................................... 9
Alias Name ..................................... 9
Animal Registered Name ......................... 9
Animal's Sex ................................... 9
Birth Date ..................................... 9
Death Date ..................................... 9
Breed Name ..................................... 9
Breeder Name ................................... 10
Comment ........................................ 10
Country Name ................................... 10
Data Reliability ............................... 12
Description .................................... 12
File Path ...................................... 12
Kennel Name .................................... 12
Note Fields .................................... 12
Numerical Input ................................ 12
Published Date - Animal ........................ 13
Published Date - Title ......................... 13
Registration Number ............................ 13
Title Abbreviations ............................ 13
Title Definitions .............................. 13
DETAILED MENU ITEMS ................................ 14
Add or Revise Data ............................... 14
Add New Entries ................................ 14
Revise An Entry ................................ 15
Enter Foreign Champion Data .................... 15
Delete An Entry ................................ 16
Enter Alias Name Data .......................... 16
Reorganize Data File ........................... 16
Sequential File Processing ..................... 16
Generate Reports ................................. 18
Create Pedigree ................................ 18
Line Breeding List ............................. 19
Top Producing List ............................. 20
Descendant List ................................ 20
List Data File ................................. 21
List Names In Alphabetical Order ............... 21
Statistical Summary ............................ 21
Search for Kennel Name ......................... 21
Find Comment Text .............................. 22
Search for Breeder Name ........................ 22
Search for Titles Awarded ...................... 22
PEDIGREE (c) 1988-1995 Charles H. Orange
Search for Medical Clearance ................... 23
Setup Program Information ........................ 24
Printer Setup .................................. 24
Install License Registration ................... 28
Supplemental Title Definition .................. 29
Color Setup .................................... 30
Setup Country Information ...................... 31
ERROR HANDLING ..................................... 32
Alias Is Not In Data File ........................ 32
Animal and Parent can't have same name ........... 32
Animal Is Not In Database ........................ 32
Animal Is Not Of This Sex ........................ 32
Animal Is Of Opposite Sex For Offspring .......... 32
Can't Delete Animal's Name ....................... 32
Can't Replace Animal With Itself ................. 33
Conflicting Comment Data ......................... 33
Conflicting Foreign Data ......................... 33
Conflicting Record Data .......................... 33
Conflicting Supplement Data ...................... 33
Control Code Not Valid ........................... 34
Data File Was Made by Wrong Version .............. 34
Error In Writing Config File ..................... 34
Index Files Are In Error ......................... 34
Name Can't start with '#' symbol ................. 34
Name Is Already In Alias File .................... 34
Name Is Already In Data File ..................... 34
Not A Valid Date ................................. 35
Not a Valid Directory Path ....................... 35
Not Enough Memory to Continue .................... 35
Only 300 records allowed without registering ..... 35
Published Data Does Not Agree .................... 35
Sire and Dam can't have same name ................ 35
DATA FILE MANAGEMENT ............................... 37
File Reindexing .................................. 37
File Verification ................................ 37
APPENDIX A ......................................... 38
Sequential File Structure ........................ 38
Breed.DA* Files ................................ 38
APPENDIX B ......................................... 41
Upgrading From Previous Versions ................. 41
Upgrading From Version 1.xx .................... 41
Upgrading From Version 2.xx .................... 42
APPENDIX C ......................................... 43
DOS Input/Output Error Messages .................. 43
LICENSE AGREEMENT .................................. 44
Terms and Conditions of Use....................... 44
Terms and Conditions of Copying .................. 44
ORDER FORM ......................................... 45
PEDIGREE (c) 1988-1995 Charles H. Orange
INTRODUCTION
PEDIGREE is a program to keep track of dog pedigrees, American Kennel
Club Titles, and supplemental information (OFA, BAER, CERF, etc.) The
original intent for writing this program was to keep track of pedigree
data for our own line of dogs only. I soon expanded it to maintain
show title information and enlarged my data file to include as many
animals as possible in our breeds. I wrote the program to be flexible
enough to allow historical data from old books, foreign pedigrees and
show catalogs to be used as well as the American Kennel Club Stud Book
and American Kennel Club Awards periodicals. I provided for the
inclusion of customized titles or awards in addition to the A.K.C.
recognized awards. The most recent version includes provisions for
customizing all title and award fields to make the program useful in
other countries.
I am releasing this program for distribution as user supported
software subject to the license agreement at the end of this manual.
The non-registered version of the program will only support 300 animal
records. There is a registration form at the end of this document and
one in a separate file named PEDIGREE.ORD on the distribution disk.
The registered version of the program will support over 2 million
animal records. There is no difference between the registered version
and the non-registered version except for the limit to the number of
animal records. I welcome all comments, suggestions and ideas for
improvements as well as reports of problems from users. I will try to
incorporate as many improvements as possible in future releases.
This program is not in the public domain and is not distributed as
free software. You may use this product on a trial basis only in
order to determine it's suitability to your needs. If you wish to
continue using the product on a regular basis, you must register by
sending $40.00 to the address listed below. Registered users will be
able to receive telephone support and will be sent announcements of
future upgrades and additional products as available.
A trial copy of the latest version of PEDIGREE on floppy disk is
available from the address below for $4.00 (U.S.) to cover shipping
and handling.
Product support for unregistered users is available by mail from:
Charles H. Orange
P.O. Box 20
Downers Grove, Ill. 60515
Electronic mail may be directed to my PEDIGREE Support bbs at:
(708) 964-8912 8-n-1 - 14400 bps
The latest version of PEDIGREE is always available for downloading
from this bbs.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 1
OVERVIEW
PEDIGREE is a program to aid in the keeping of dog pedigree and title
records. It consists of two basic parts accessible from a menu:
one to add or change records,
and one to create pedigrees and other useful reports.
A complete description of each process is given in the following
sections.
Reports generated include three to thirty generation pedigrees, seven
generation line breeding lists, lines of descendancy and top producing
sire and dam lists.
Data may be input from any number of sources. The complete selection
of A.K.C. awards may be entered as well as data from other sources.
As new data is entered, it is checked against any data in the system.
Any discrepancies that are found will display an error message and the
new data will not replace the data already in the system.
PEDIGREE is menu driven with a single letter required to move to an
item on a menu. This choice may be a function of the program, or
another menu of items. To exit to the previous menu, press the
<ESCAPE> key. Help topics are available at all menus and at all
places requiring keyboard input. Help is available by pressing the
function key <F1>. An index of the major Help Topics is available by
pressing <F1> again.
The program files are as follows:
PEDIGREE.EXE the pedigree program itself.
PEDIGREE.HLF the help file.
PEDIGREE.CFG configuration data created by PEDIGREE
Supplemental files for documentation and installation only:
PEDIGREE.DOC this document file.
PEDIGREE.ORD an order form for registration.
PEDIGREE.REV list of revision level changes.
PED1SEQ.EXE conversion program from version 1 files.
PED1SEQ.DOC instructions for PED1SEQ.EXE conversion.
README.1ST quick start instructions.
The data files are created as follows:
Breed.CFG the breed setup file.
Breed.DAT the main database file.
Breed.IX the index file.
Breed.DIA restart file for data integrity.
Breed.TXT text file output for other programs.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 2
Chapter I - GETTING STARTED
SYSTEM REQUIREMENTS
Computer: IBM PC or compatible with at least 384k memory. A hard
disk with a minimum of 1mb of free space is required.
The data files require a minimum of 342 bytes per
animal to a maximum of 1796 bytes. A data file of
fewer than 900 animals would fill a 360k floppy disk.
Printer: Any printer should work. A printer that supports the
IBM extended character set can print pedigrees with
lines connecting related animals. In printing a
listing of the complete data file, a printer capable of
printing 160 characters on a line may be utilized to
print on fewer pages. Printer definition codes may be
entered when the program is run. The default settings
are for Epson printers.
Monitor: Any monitor that supports IBM monochrome displays may
be used. Color is supported but not required for the
program to operate.
PROGRAM INSTALLATION
The first step in getting started with PEDIGREE is to make a back-up
copy of the disk. Consult your DOS manual for any details of the copy
process that you are not sure about. Take your original disk and put
it away in a safe place.
As PEDIGREE is distributed by various shareware sources, the exact
file names on your disk may vary somewhat from the following, but the
method of installation is the same. if your floppy disk has a program
named 'INSTALL.EXE' in it's directory, simply place the floppy disk in
drive A: (or B:) and type the following:
A:INSTALL <enter> (or B:INSTALL <enter>)
Follow the on screen directions to create a PEDIGREE directory and
install the software. You will be prompted for the name of a hard
drive and directory to use for the program files. You may press
<enter> to accept the defaults or enter your own choices. You may
print a copy of this manual or order form if desired.
If your disk does not contain an install program, you must create a
directory on the hard disk named \PEDIGREE. Copy the files
PEDIGREE.EXE and PEDIGREE.HLF from the distribution disk into this
directory. This will become your working directory for the breed data
files also.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 3
Change the file CONFIG.SYS on your boot disk to include the following
lines:
buffers=20
files=20
Any number for files or buffers equal or greater than twenty is
acceptable. If no CONFIG.SYS file exists on your boot disk, then
consult your DOS manual for instructions on creating text files using
the COPY command from the keyboard.
For advanced DOS users, with DOS version 3.0 or greater, the
PEDIGREE.EXE file may be either in the current directory or in the DOS
Path. The PEDIGREE.HLF file must be either in the current directory,
or in the same directory as PEDIGREE.EXE.
Change drives and directories to the one that contain your working
copies of PEDIGREE.EXE and PEDIGREE.HLF or to the directory where you
want the breed data files to be stored. You are now ready to run the
program.
Start PEDIGREE (from the C:\Pedigree directory) by typing:
PEDIGREE <Enter>.
After you have read the introductory screen, press any key to be
prompted for a breed name. The breed name will become the name of the
files created by the computer. If a name longer than 8 characters is
used, only the first 8, or up to the first space in the name will be
used for the file names. The entire breed name will be saved for use
on reports. If the breed name entered is found on the disk, the
existing files are opened. If the name is not found, confirmation is
required before new data files are created. Pressing the <F5> key at
the prompt for Breed Name will pop up a window with a list of the
breeds currently in this directory. You may select one by moving the
higilighted entry with the arrow keys and pressing <Enter> or <F10>.
Alternatively, you may enter the breed name on the command line after
the word PEDIGREE, such as:
PEDIGREE SIBERIAN
If this is the first time you are using this breed, a message will
state that no database exists and prompt for creation of a new one.
Answering 'Y' to this question will start the creation of new breed
files. Creating a new database follows the same procedure as the menu
selection of 'Setup Program Information' and 'Define supplemental
titles' once the program has been run. You may go back to this menu
selection at any time and change your selections.
The first step in creating new breed data files is fill in the entire
breed name for later use on reports. The question about redefining
the A.K.C. awards should be answered next. For United States users
who are working with American Kennel Club registered dogs, this should
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 4
be answered 'N'. Users from other countries or those with dogs
registered with other kennel clubs should answer 'Y'. If the A.K.C.
awards are not changed, then sixteen additional titles may be defined
for any awards desired. The first twelve awards will follow the
A.K.C. standards for abbreviation and method of display. If the
A.K.C. awards are changed, then all 28 awards may be defined.
Changing the A.K.C. awards also replaces the eleven character AKC
number field with a twenty character REG number field. This is more
flexible for international users.
Each title definition consists of a three parts:
The formal title is used on the Statistical Summary of the data
file. This is the proper name for a Title and is limited to 30
characters.
An abbreviation of the title will be reported with all references
to an animal's name. The abbreviation is limited to 8
characters.
The position for the title will determine whether the title goes
BEFORE, AFTER, or UNDER the animal's name. Another possibility
for title position is NEVER, which will cause the title to be
printed only on the listing of the entire database. It would
never be printed on a pedigree or other report. Title position
is selected with the up or down arrow keys when the cursor is
over the 'Title Prints' field.
Some examples are:
Formal Title Abbreviation Position
Certificate of Gameness CG After
Register of Merit ROM After
Field Winner FW Before
When an animal's name is displayed, the first title defined will be
closest to the name, either before, after or under as defined.
Entry of data on animals with these titles will be done from the Add
New Data menu item.
When the first screen of titles is completed, press <F10> to accept
the selections from this screen. A second screen of titles (initially
undefined) will appear and be ready for customization if desired.
Press <F10> when you are finished changing any titles desired.
There are three user defined fields available for tracking any
information. The headings for these fields may be changed to anything
up to 20 characters long. These headings and the data in the fields
for each animal will be printed whenever extended data is requested on
a report.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 5
Answer 'Y' or 'N' to the question about dual registration of this
breed. If dual registration is selected, there will be two additional
fields of data on each entry screen. One field is for the
abbreviation of the second registering body, and the other field is
for the registration number. An example of using dual registration is
for those animals shown in both the U.S. and Canada and are registered
in both countries.
After answering the above, press <F10> to end the customization of
titles.
After completing the customization of titles, the main menu will
appear. The functions will be described in the remaining sections of
this manual except for the Exit function, which saves your data,
closes all files and ends the program. Always exit the program before
turning off your computer as valuable data may be lost otherwise.
If the American Kennel Club and U.S. information is intended to be
your primary focus, you are ready to enter data about individual
animals in your breed. If you intend to work primarily with data
from other countries, you should read the section on Setup Domestic
Country Information in Chapter III.
Before printing any reports, you will have to configure the settings
for your printer. You should read the section on Setup Printer
Information in Chapter III.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 6
Chapter II - RUNNING PEDIGREE
Start PEDIGREE (from the C:\Pedigree directory) by typing:
PEDIGREE <enter>.
If the display on a monochrome monitor or laptop computer is not clear
because of color selection, the program may be started with a command
line parameter of '/m' to force monochrome output. This should
increase legibility on laptop displays.
eg: PEDIGREE /m or PEDIGREE AIREDALE /M
ACCESSING THE HELP SYSTEM
When the program is started a message appears on the lower center of
the screen to show whether help is available or not. If the help file
is not found, the message will say 'Help File PEDIGREE.HLF not found.'
If the help file is found, the message will say 'Press <F1> for help.'
If help is available, the help system may be activated at any time by
pressing the <F1> key. The first help message will be information
concerning the current menu command or required input line. If the
help for the current topic requires more than one screen for display,
a message will appear in the lower border for <PgUp>/<PgDn> for more
help. An index of help topics may be obtained by pressing <F1> again.
Further topics may be selected from this index by using the cursor
keys to position the highlight over the topic and pressing <Enter>.
The help system may be exited by pressing <Escape> at any time.
CONVENTIONS FOR INPUT
The following conventions for input are used throughout PEDIGREE for
navigating the menus and entering data as required.
MOUSE USAGE
If a mouse is present, the program will respond to it's usage. The
mouse may select a menu item by moving the mouse cursor over an entry
and pressing the left mouse button to select. The right button acts
like the <Escape> key. Entry fields may be selected for input by
selecting in the same manner. Pressing the right button will discard
the present entry. Pressing both mouse buttons together act like
pressing the <F10> key. Multiple selection items may be selected by
two clicks of the left mouse button.
SELECTING MENU ITEMS
Menu items may be selected by pressing the highlighted letter, by
pressing the left mouse button with the mouse cursor on the item, or
by using the <Up Arrow> or <Down Arrow> key to highlight the item and
pressing the <Enter> key.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 7
KEYBOARD ENTRY EDITING
edit keys available:
<Escape> ...................... abort the entry with no changes.
<Insert>, Ctrl-V .............. toggle insert/overwrite mode.
<Back Space>, Ctrl-H .......... delete character left of cursor.
<Delete>, Ctrl-G .............. delete the character under the cursor.
Ctrl-Y ........................ delete the entire field.
<Left Arrow>, Ctrl-S .......... move 1 character left in field.
<Right Arrow>, Ctrl-D ......... move 1 character right in field.
Home .......................... move to beginning of field.
End ........................... move to end of field.
<Enter>, <Tab> ................ accept input from field.
The following edit keys are available for multiple field editing:
<Enter>, <Tab> ................ move to next field.
Shift-<Tab> ................... move to previous field.
Ctrl-<Home> ................... move to first field.
Ctrl-<End> .................... move to last field.
<F10> ......................... accept all fields on screen.
<Escape>....................... abort the entry field with no changes.
Other edit keys will be displayed in the border when available.
Whenever keyboard input is required for multiple fields on a screen,
the only ways to exit the input mode are to press the <F10> key or one
of the keys displayed in the border to accept the entry, or press the
<Escape> key to discard the entry. The <Enter>, <Tab>, or Shift-
<Tab> keys will only move from one field to the next without accepting
the inputs. When keyboard input is required for only one field, the
<Enter> key will accept the input.
Overwrite mode of keyboard operation is the default. When insert mode
is toggled on, the cursor appears as a fat block instead of an
underline.
When editing a field, if the first character entered is a printable
one, the existing contents of the field will be deleted. If the
existing contents are to be saved, start the entry with one of the
above defined edit keys.
INPUT FIELDS
Where text or numerical inputs are required, they take the following
form:
The entry length is limited to the size of the underline.
Date fields are forced into the proper format.
Alphabetic input is rejected if numeric input is required.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 8
AKC NUMBER
The AKC number is input with a two letter prefix followed by a 6 digit
number. With newer numbers, the number is a litter number followed by
a slash and a number from 0 to 99. Either upper case or lower case
may be used. If there is only one letter in the prefix, use a '-' in
place of the second letter.
ALIAS NAME
A field for an additional name by which a specific animal is known.
The same limits apply as to the animal's registered name.
ANIMAL REGISTERED NAME
The registered name of the animal in question. Do not include any
Championship or Obedience Titles. Length is limited to 50 characters
including spaces and punctuation. To search for an existing name in
the database, part of the name may be entered followed by <F5>. This
will display an alphabetic list of animal names starting with the
characters typed. An animal may be selected from this list by
highlighting the name and pressing <F10> or <ENTER>. If the name
isn't found in the selection list, press <ESC> and finish typing the
name. If the entry number for an animal in the database is known,
that number may be used following a '#' symbol. This will speed up
repetitious entry of names.
ANIMAL'S SEX
For dogs use 'M' or 'D'. For bitches use 'F' or 'B'.
Either upper case or lower case may be used. If sex is not known, use
either a <SPACE> or an <Enter>. Any other character will be ignored.
BIRTH DATE and DATE OF DEATH
The month, day and year inputs should be in the format which has been
selected from the 'Setup Domestic Country Information' menu item. The
valid formats are of a one or two digit month (or day,) followed by
any of '/', '-', '.', or space, a one or two digit day (or month,)
followed by any of '/', '-', '.', or space, then the year. The year
may be two or four digits. If only two digits, the year is assumed to
be in the 20th century (eg. 88 becomes 1988).
The following are all acceptable examples:
05/03/87 5/3/1987 5-03-87 05,03,1987 5 3 87
BREED NAME
The first word of the breed name (up to 8 characters) will become the
name of the files created by the computer. The entire breed name will
be used for titles to some reports. If records for more than one
breed are to be kept on the same disk, be certain that the first word
in each name is different. If the name is found on the disk, the
existing files are opened. If the name is not found, confirmation is
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 9
required before new data files are created.
Press <F5> to select the breed from a list of existing files.
The breed name may also be included as a parameter on the command line
when starting the program.
BREEDER NAME
An unformatted field for the name of the breeder/owner of the animal.
COMMENT
An unformatted field for any comments about the animal.
COUNTRY NAMES
The input of an abbreviation for a country name is required.
Suggested abbreviations are the ones used by the International Olympic
Committee.
AFG Afghanistan ETH Ethiopia MEX Mexico
ALG Algeria FIN Finland MGL Mongolia
AND Andorra FRA France MLI Mali
ANG Angola FRG West Germany MLT Malta
ARG Argentina GBR Great Britain MOZ Mozambique
AUS Australia GDR East Germany NCA Nicaragua
AUT Austria GRE Greece NEP Nepal
BAH Bahamas GUA Guatemala NGR Nigeria
BAR Barbados GUI Guinea NOR Norway
BEL Belgium GUY Guyana NZL New Zealand
BEN Benin HOL Netherlands PAK Pakistan
BER Bermuda HUN Hungary PAN Panama
BIR Burma INA Indonesia PER Peru
BOT Botswana IND India POL Poland
BRA Brazil IRL Ireland POR Portugal
BUL Bulgaria IRQ Iraq PKR North Korea
CAN Canada ISL Iceland PUR Puerto Rico
CGO Congo ISR Israel QAT Qatar
CHI Chile ITA Italy ROM Romania
CHN China JAM Jamaica SAU Saudi Arabia
CIV Ivory Coast JOR Jordan SEN Senegal
CMR Cameroun KEN Kenya SEY Seychelles
COL Columbia KOR South Korea SLE Sierra Leone
CRC Costa Rica KUW Kuwait SMR San Marino
CUB Cuba LAO Laos SRI Sri Lanka
CYP Cyprus LBA Libya SUD Sudan
DEN Denmark LES Lesotho SUI Switzerland
DJI Djibouti LIB Lebanon SWE Sweden
DOM Dominican LIE Liechtenstein SYR Syria
Republic LUX Luxembourg TAN Tanzania
ECU Ecuador MAD Madagascar TCH Czechoslovakia
EGY Egypt MAL Malaysia THA Thailand
ESP Spain MAR Morocco TPE Chinese Taipei
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 10
TRI Trinidad and
Tobago
TUR Turkey
UGA Uganda
URS U.S.S.R.
USA United States
VEN Venezuela
VIE Vietnam
YUG Yugoslavia
ZAM Zambia
ZIM Zimbabwe
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 11
DATA RELIABILITY
The data reliability number is a number between 0 and 255. The higher
the reliability of the source of data, the lower the number should be.
Any data input from an official AKC publication automatically has a
reliability number of 0. The entries created for sires or dams will
start out with a reliability of 255. Numbers between should be used
for other data sources. Consistency should be maintained to keep
track of data sources. This should enable back-tracking in the event
of conflicting data from different sources.
DESCRIPTION
An unformatted field for any descriptive data.
FILE PATH
A valid path to a directory or subdirectory is required. The
directory and drive must both exist. A blank entry will use the
current directory. A single character is valid as a root directory on
that drive. The trailing '\' is not necessary, as it will be
automatically added if left off.
Valid examples are:
A:
A:\
b:\terriers
b:\TERRIERS\MYDOGS\
KENNEL NAME
The input consists of a string to be searched for within an animal
name. This string may be either a whole word or characters included
within longer words. Punctuation is ignored, but spaces between words
are significant.
NOTE FIELDS
A 'Y' in the note fields entry will open an entry window for the free
form entry of notes about an animal. These notes will be printed as
footnotes on an annotated pedigree. There are fifteen lines of 65
characters each available for entry. All of the editing controls
listed under Keyboard Entry Editing may be used to edit the text in
the note field.
NUMERICAL INPUT
The input of a whole number is required. Digits 1 through 9 and 0 are
the only acceptable input keys. An <Enter> is required to end the
input. An error message will be displayed on the bottom screen line
inputs if the entry is not within the acceptable range.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 12
PUBLISHED DATE - Animal
The month and year of stud book entry should be in the format of a one
or two digit month followed by any of '/', '-', '.', or space followed
by the year. The year may be two or four digits. If only two digits,
the year is assumed to be in the 20th century (eg. 87 becomes 1987).
If the month is not known, enter 00/87 for any time in 1987. If a
title is known to exist but no date is known, enter y or yes.
The following are all acceptable examples:
05/87 5/87 05/1987 5-87 5,87 5 87 05 1987
PUBLISHED DATE - Title
As above, enter the date the title was published, or enter a 'Y' if
the date is not known but the title has been awarded.
REGISTRATION NUMBER
The registration number may be input in this field. As there are
differing registration number-letter sequences in different countries,
there are no checks to determine proper format for this field.
TITLE ABBREVIATIONS
The abbreviation for Titles should be limited to 8 characters.
Abbreviations will be attached to the animal's name on reports.
TITLE DEFINITIONS
The proper name for a Title should be limited to 30 characters. Some
examples are:
Champion of Record
Certificate of Gameness
Working Certificate
Register of Merit.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 13
DETAILED MENU ITEMS
ADD or REVISE DATA
Selecting 'ADD or REVISE DATA' will bring up another menu showing
choices for adding, revising or deleting records from the main
database; as well as choices for adding or deleting foreign champion
data and alias names. Two selections for reorganizing the database
and creating sequential file output are described in detail in the
section on Data File Management.
Add New Entries To Database:
If the A.K.C. titles have been left unchanged, the selection of 'Add
New Entries' will display a list of possible sources for new data. If
the titles have been modified, the selection of 'Add New Entries' will
be identical to adding data from other sources below. If the animal
is found in the data file then only blank fields will be available
for input. When inputs are from A.K.C. publications, the date of the
publication will be required before the animal entry screen is
displayed and only fields that are in the A.K.C. publication will be
available for input.
Inputs may come from the following sources:
From AKC Stud Book
Championships From AKC Gazette
CD Titles From AKC Gazette
CDX Titles From AKC Gazette
UD Titles From AKC Gazette
TD Titles From AKC Gazette
TDX Titles From AKC Gazette
OTCH Titles From AKC Gazette
AFC Titles From AKC Gazette
FC Titles From AKC Gazette
JH Titles From AKC Gazette
SH Titles From AKC Gazette
MH Titles From AKC Gazette
Data From Other Sources
Data From Other Sources includes such items as records of the
customized titles or data from pedigrees and other publications. A
default data reliability is entered for this entry session. The data
reliability entry should reflect the confidence in the accuracy of the
source of data. A lower number for reliability indicates a lower
chance of bad data. If the animal is found in the data file, then
only blank fields will be available for input. All empty data fields
are available for input.
There is a second chance to ignore data that has just been entered.
After all fields have been entered, the cursor will move to the first
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 14
highlighted field on the screen. The cursor may be moved to any field
available for input at any time. This allows for corrections and
additions to the data. If there are any errors in the data fields,
pressing the <Escape> key will erase the screen and start over.
Pressing the <F10> key will accept the data as shown. Pressing the
<F9> key will also accept the data as shown and will present a second
screen with choices to add supplemental data on the animal. When the
supplemental data has been entered, press <F10> to accept the data as
shown.
For entries made using 'Data From Other Sources' there will be four
additional function key choices highlighted in the screen border.
These choices will allow immediate addition of data about an animal's
sire <F7>, or dam <F8>, or the addition and revision of foreign data
<F6>, or returning to the immediately previous animal entered <F4>.
Revise An Entry:
The selection of 'Revise an Entry' will request an animal name for
data revision. All fields of data may be revised. Care should be
taken for it is possible to revise not only an animal's name, but to
change the names of the animal's sire and dam. If there are any
errors in data revised, pressing the <Escape> key will erase the
screen and start over. Pressing the <F10> key will accept the input
data as shown. There will be four additional function key choices
highlighted in the lower screen border. These choices will allow
immediate addition or revision of data about an animal's sire or dam,
or the addition or revision of foreign data or supplemental
information about the animal.
Enter Foreign Champion Data:
Foreign Champion data is entered from a second screen selected after
entering data or revising an entry. This screen is available when the
prompt '<F6>Foreign' is displayed in the lower border.
Foreign Champion Entries may be entered with an abbreviation for the
country. This will allow limited record keeping of animals with
foreign titles. There are positions for up to 25 abbreviations of
foreign country names.
Foreign Champion Entries made by mistake may be removed from the data
file. The country should be deleted from the field with either a
Control-Y at the beginning of the field or repeated use of the
<DELETE> key. If all Foreign Champion Entries for the animal have
been deleted, the foreign record will be deleted from the database.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 15
Delete An Entry:
The selection of 'Delete an Entry' will allow an entry to be removed
from the data file or exchanged for another if duplicate entries have
been made with misspellings of name. Confirmation will be requested
before any action is taken. If a replacement name is specified, the
data on the two records will be combined in the record for the
replacement name. Records for all offspring will be changed to show
the replacement name as parent. If there is any conflicting data an
error message will be displayed and no changes will be made.
Enter Alias Name Data:
The selection of 'Enter Alias' name data will allow a second name to
be entered or deleted for an animal. This is useful for an imported
animal that has a different registered name in another country. The
entry in the data file should be the name by which the animal is
registered with the A.K.C. while the alternate name or names used are
added here. Alias names may also be added from the supplemental data
screen after entering or revising animal data. Existing Alias names
for an animal are displayed in a list which appears below the entry
line. If the alias already exists, press <ENTER> to leave the line
blank. If the alias is not on the list, type in the new alias name
for the animal. When an alias name is used to find an animal, the
proper name of the animal is substituted for the alias in displays or
printed reports. Alias names are used only for determining the
registered name of an animal.
Reorganize Data File:
The selection of 'Reorganize the Data File' will be useful if some of
the files have been damaged by a power failure or through some fault.
The possibility of data loss from this may be reduced by keeping
regular back up disks of data files.
Sequential File Processing:
'Sequential File Processing' will be used to import or export data for
other programs or to share with another PEDIGREE user. Currently, no
other programs have been written to take advantage of this feature. A
valid drive or directory entry is required to find the sequential
ASCII files for data transfer. Appendix A describes the structure of
the sequential files created. These files may be directly imported
into a word processor or commercial database manager if desired.
This sequential file processing feature is used as described in
Appendix B for the transfer of files from previous versions of
PEDIGREE into this version.
Sequential files may be created from the main data files. When
creating sequential files, either all records are placed in the file,
or records modified on or after a specified date are placed in the
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 16
file.
Note: It has been previously stated that the Comments Field for
an animal will never print out on any report. These Comments
Fields are in the file named 'Breed.DA6' which is created as a
sequential file. If you are making data available to others and
don't want to include your private comments about animals, simply
delete 'Breed.DA6' from the files which you distribute to others.
Sequential files may also be appended to the main data files. The
appending process checks for discrepancies between the main data files
and the sequential files. Any records with discrepancies are not
appended to the data files, but are entered in a file named
'Breed.ERR' in the same directory as the main data files. The
contents of the data file entry for an animal are listed along with
the conflicting information from the sequential file being added.
In order for the appending process to work correctly the sequential
data files must have been created by PEDIGREE ver. 1.10 or later, and
all titles in the sequential file must refer to the same information
as the corresponding field in the data file. If any title definitions
have been changed, special care must be taken to insure that the title
names in the main data file are in the same order as the title names
in the sequential files being read in. The title structure of the
sequential files is in the file named 'Breed.DA0'. The title
structure of the main data file is in the file named 'Breed.CFG'.
Although the structure of these files are different, they are both
plain ASCII text files which may be compared or read into a word
processor.
These files may be used by other programs if desired or may be read
into a word processor. They are plain ASCII files with fields
separated by a comma and each entry is terminated with a carriage
return and line feed.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 17
GENERATE REPORTS
The selection of 'Generate Reports' will allow the making of pedigrees
and other useful information for breeding selection. The entire data
file and an alphabetical list of registered names also may be printed.
All output may be directed to the printer, the screen, a file, or an
alternate printer. A prompt for the output will appear with the
currently selected output highlighted. Use the cursor keys to change
the desired output and press <ENTER> to select. The current selection
will be highlighted the next time output is created. If output is
directed to a file, the data is appended to the end of the file named
'breed.txt' in the current directory. If output is directed to the
printer or alternate printer, the program checks to make certain that
the printer is turned on before any data is printed. An error message
will appear if the printer is not ready. Simply correct the problem
and press any key to continue.
The following is a descriptive list of the available reports:
Create Pedigree:
A sub menu will appear with choices for generating a pedigree or
scrolling through a pedigree on the screen. Generating a pedigree
will allow for a pedigree to be printed with up to 30 generations of
ancestors. Pedigrees over 5 generations long will not print on one
sheet of paper. The number of ancestors (and the size of the
pedigree) doubles with each additional generation. A pedigree of the
maximum 30 generations would contain a total of 4,294,967,296 entries,
and would require 53,687,092 sheets of paper to print.
A pedigree with a blank line for later filling in of the animal's name
can be made by using an asterisk (*) in place of the name. This
allows for creating a pedigree for an as yet unregistered puppy.
Proposed breedings can be seen by filling in a fictitious name and
then answering the requests for sire and dam.
Extended data may be printed on the pedigree. This extended data
consists of all titles which are defined as printing under an animal's
name, any data in the three information fields and the description
from the supplemental data input screen. The extended data may be
printed for all animals which are in the pedigree, or for only the
main animal.
The Birth Date, Sex, and AKC Registration will also be printed for the
main animal. Dual registered animals will have the alternate Kennel
Club abbreviation and registration number printed.
An annotated pedigree may be printed containing a separate page with
the notation fields for each animal in the background printed. Each
animal is referenced as to it's position in the pedigree.
Scrolling through a pedigree on the screen will allow for the movement
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 18
in either direction through the generations on a pedigree. After
displaying the pedigree of an animal, there are 3 keys which will
navigate through the pedigree. The pedigree may be scrolled one
generation in either direction.
To scroll to the Sire's pedigree, press the 'S' or the 's' key.
To scroll to the Dam's pedigree, press the 'D' or the 'd' key.
To scroll to the next generation, press the 'O' or the 'o' key. A
selection list of offspring will be shown. Highlight an entry and
press either the <Enter> or <F10> key to display that animal's
pedigree.
Line Breeding List:
A line breeding list is a listing of the ancestors in the previous 7
generations. Each animal is listed only once with a key to the
generations and frequencies of appearance in the pedigree. A line
breeding list may be printed sorted either by genetic weight of the
ancestors or by frequency of appearance in the background. The line
breeding list shows the generations in which an animal appears with
the sire's side on the left and the dam's side on the right of a
colon. For example:
14.062% CH Back Ancestor (7557:4)
implies that CH Back Ancestor appears in the 7th generation twice, and
in the 5th generation twice on the sire's side of the pedigree; and in
the 4th generation once on the dam's side of the pedigree.
The percentage of genetic contribution which an animal provides in all
generations is listed. The percentage in the above example is
calculated as follows:
seventh generation: 128 ancestors > 1/128 * 2 appearances = .01562
sixth generation: 32 ancestors > 1/32 * 2 appearances = .06250
fifth generation: 16 ancestors > 1/16 * 1 appearance = .06250
Total genetic contribution for all generations = .14062
The number of ancestors not included in the report is printed.
The total genetic contribution of each generation must total 100%.
Because of this, the total for all 7 generations will add up to 700%.
This will explain why an animal may contribute more than 50% of the
genetic background through appearance in more than one generation.
Extended data may be printed on the line breeding list. This extended
data consists of all titles which are defined as printing under an
animal's name, any data in the three information fields and the
description from the supplemental data input screen. The extended
data may be printed for all animals which are in the pedigree, or for
only the main animal and it's sire and dam.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 19
Top Producing List:
A list of sires or dams with the highest number of titled offspring
may be produced. The minimum number of titled offspring for inclusion
on the list must be specified. This number must be one or greater in
order to produce a report. The titles to be used must be selected
from the displayed list. Select the titles by moving the cursor with
the cursor control keys and press <SPACE> to select or deselect a
title. At least one title must be selected. The list will be sorted
from highest to lowest number of titled offspring produced. The
number in parenthesis is the number of titled offspring. If only one
title has been selected then the listing for each offspring contains
the animal's sex and the publication date of the title. The offspring
are listed in order of birth date.
Foreign titles may be included or excluded from the count in searching
for qualified top producers if desired.
The list may be printed with only the names of the top producers and a
count of the number of qualifying offspring or the list may be printed
containing the names of the qualifying offspring.
Descendant List:
A list of descendants from an animal may be produced. The list can
either include all descendants or only continuous lines of titled
descendancy. The titles to be used must be selected from the
displayed list. Select the titles by moving the cursor with the
cursor control keys and press <SPACE> to select or deselect a title.
If no titles are selected then all offspring will be included.
Foreign titles may be included or excluded from continuing the lines
of descent included.
The list may be further limited by selecting either tail male or tail
female lines of descent, which will produce a listing containing
offspring of only one sex.
The generation appears in parenthesis before each animal's name. The
sex of each animal appears at the right of the line. If the list was
requested only to contain continuous title lines for only one title,
the issue date of the title is also on the right of the entry.
The list may include the opposite parent's name along with the name of
each descendant if desired. If this name is included, the date of the
animal's title or the sex of the animal will not appear.
The length of the list may be limited by requesting only those animals
within a specific number of generations be considered for inclusion.
This will be helpful for producing descendant lists of animals who are
top producers when only the first few generations are relevant as it
considerably reduces the time and paper consumed.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 20
Extended data may be printed on the descendant list. This extended
data consists of all titles which are defined as printing under an
animal's name, any data in the three information fields and the
description from the supplemental data input screen.
List Data File:
The contents of the data file may be printed in sequential format.
The listing will include all data entered for every animal in the
database.
Titles and their dates will be enclosed in brackets, and up to four
lines will be used if there is any supplemental information or com-
ments about an animal. Up to an additional fifteen lines may be used
if there is a note field used for an animal.
List Names In Alphabetical Order:
An alphabetical index of animals in the data file may be printed.
This list contains a cross-reference number to the entry in the
complete data file.
The format will be as follows:
1701 $ Animal Name A 300 # Animal Name C
31 * Animal Name B 5122 Animal Name D
The symbols between the number and the name indicate the following:
$ Birth date and Sex of animal are known
# Sire and Dam of animal are known
* Sire, Dam, Birth date, and Sex of animal are known
The listing will be in three columns on paper if the printer setup has
been specified that 160 characters may be printed on one line. If 160
characters per line is not available, the page will contain only two
columns. Output to the screen will be one column wide.
Statistical Summary:
This selection will count the entries in the data file and report on
the number of animals in each category.
Search for Kennel Name:
This selection will list all animals whose names have a word or kennel
name in common. The list may be names only, or all data for the
animal. Any string of letters and spaces in the database of animal
names may be searched for. Be cautious of searching for too short of
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 21
a word or part of a word because of the large number of names which
might be selected.
An example of a string of characters to search might be 'Jones'. This
will find the following names:
Best of Jones
Jonestown Better
J'Ones Greatest
This will not find the following names:
J' Ones Greatest
Jon Estimate
Find Comment Text:
This selection will list all animals that have a comment record which
contains the text specified. The list may be names only, or all data
for the animal. Any combination of letters and spaces in the comment
field of an animal record may be searched for. The search may be
specified to be insensitive to upper/lower case letters, or look for
an exact match by case. Be cautious of searching for too short of a
word or part of a word because of the large number of names which
might be selected. Since the file is not indexed on the comment
field, this search must read the entire data file looking for the
specified text. This is a time consuming operation in direct
proportion to the number of animals in the data file.
Search for Breeder Name:
This selection will list all animals whose breeder name has a word or
name in common. The list may be names only, or all data for the
animal. Any string of letters and spaces in the database of breeder
name may be searched for. Be cautious of searching for too short of a
word or part of a word because of the large number of names which
might be selected. Since the file is not indexed on breeder name,
this search must read the entire data file looking for the specified
text. This is a time consuming operation in direct proportion to the
number of animals in the data file.
Search for Titles Awarded:
This selection will list all animals who were awarded specific titles
in a given month or year. The list may be names only, or all data for
the animal. A specific month and year may be entered to search for
only awards that month. To search for awards for a complete year,
enter '0' as the month followed by the year.
eg: 0/1993 for any awards in 1993.
The titles to be used must be selected from the displayed list.
Select the titles by moving the cursor with the cursor control keys
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 22
and press <SPACE> to select or deselect a title. At least one title
must be selected. Since the file is not indexed on title dates, this
search must read the entire data file looking for the specified title.
This is a time consuming operation in direct proportion to the number
of animals in the data file.
Search for Medical Clearance:
This selection will list all animals that have an entry in the
specified Medical Clearance field. The list may be names and Medical
Clearances only, or all data for the animal. Any or all Medical
Clearance field may be selected for inclusion in the list. Since the
file is not indexed on Medical Clearance fields, this search must read
the entire data file looking for the specified fields. This is a time
consuming operation in direct proportion to the number of animals in
the data file.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 23
SETUP PROGRAM INFORMATION
The selection of Setup Program Information will allow you to setup the
control codes required for your printer or alternate printer, unlock
your registered version of PEDIGREE, define the titles and awards for
inclusion in the data file, setup the screen colors for your monitor
and set country specific items. The definitions for titles and
country specific items will be saved in a file only for use with the
current breed. All other program setup items will be saved in a file
configuring the program for all breeds.
Printer Setup:
To set up your printer for proper operation of PEDIGREE, you will need
to refer to the printer operator's manual or programmer's guide. You
will need to determine the correct codes necessary to configure the
printer to perform and to cancel the following operations:
printer initialization
12 character per inch printing
8 lines per inch printing
160 characters per line
letter quality printing
enhanced or bold type
If your printer is not capable of supporting any of these, the program
will still run, but the output will not be as neat as it could be.
Either the primary printer or an alternate printer may be selected to
be configured. The printer may be named to make it easier to select
for printing from the report menus. The output port to which the
printer is connected must be specified. Highlight the proper port
with the cursor keys and select with <Enter>.
The program initially configures the printer as using the Epson
character set for printer controls. The first time the program is
run, the printer configuration process should be done. Answering 'Y'
to the question of reset to default codes will restore the program to
these Epson style control codes. If you know what the proper codes
for your printer are, you may enter them. At any time the printer may
be set up again through the main menu function C.
Non-printable control codes are input as a back slash '\' followed by
a 3 digit decimal number only. For example, an ESCAPE code is entered
as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
The following sequence is used in defining a printer:
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 24
Maximum Line Length
For printing the entire contents of the database and the contents of
the alphabetical index to the database, the program will utilize a
line length of 160 characters. If the printer is not capable of
printing 160 characters on one line then these two report formats will
print out on multiple lines. The questions about condensed print mode
are asked only if the printer is capable of printing 160 characters
per line.
IBM Character Set Compatibility
For printing pedigrees with a graphic tree structure, a printer with
the IBM Extended Character set is required. If the printer is not
capable of this, then pedigrees will be printed without a line tree.
Set Left Margin Indentation
The left margin defaults to 10 character indent. This is a good value
to use if the printer is set up to print at the very left edge of the
page. If the printer is set to include a margin automatically, this
value should be reduced or set to zero.
Printer Initialization
Any codes which should be sent to the printer before printing any
output should be placed here. An example would be the codes to select
a specific typeface, or to select IBM graphics characters for the
alternate character set. This set of codes is sent to the printer
before every report.
Set Condensed Print Mode
Some printers are capable of using a wide sheet of paper to print
lines of 160 characters. If the printer is like this, the current
input line should be cleared. Other printers will require a sequence
of characters to set a condensed print mode. This set of codes is
sent to the printer before the list of animals and the alphabetic list
of names.
Reset From Condensed Print Mode
If printer codes were not used to set condensed mode then the current
input line should be cleared. Other printers will require a sequence
of characters to reset from condensed print mode. This set of codes
is sent to the printer after the list of animals and the alphabetic
list of names.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 25
Set Lines Per Page
When the printer is set up for wide sheets of paper, the number of
lines per page may not be the standard 66. In this case, enter the
actual number of lines on the page.
Set 12 Characters Per Inch
Pedigrees are printed at 12 characters per inch if possible. If the
printer is not capable of printing at 12 characters per inch, the
current input line should be cleared. Other printers will require a
sequence of characters to set the pitch. This set of codes is sent to
the printer before all reports except the list of animals, the
alphabetic list of names, and 3 generation pedigrees.
Reset From 12 Characters Per Inch
If printer codes were not used to set 12 characters per inch then the
current input line should be cleared. Other printers will require a
sequence of characters to reset the pitch to standard 10 characters
per inch. This set of codes is sent to the printer after all reports
except the list of animals, the alphabetic list of names, and 3
generation pedigrees.
Set 8 Lines Per Inch
Pedigrees are printed at 8 lines per inch if possible. If the printer
is not capable of printing at 12 characters per inch, the current
input line should be cleared. Other printers will require a sequence
of characters to set the line spacing. This set of codes is sent to
the printer before printing 4 through 30 generation pedigrees.
Reset From 8 Lines Per Inch
If printer codes were not used to set 8 lines per inch then the
current input line should be cleared. Other printers will require a
+sequence of characters to reset the line spacing to the standard 6
lines per inch. This set of codes is sent to the printer after
printing 4 through 30 generation pedigrees.
Set Letter Quality Mode
Some reports are printed in letter quality mode if possible. If the
printer is not capable of switching to letter quality, or is only a
letter quality printer, the current input line should be cleared.
Other printers will require a sequence of characters to set letter
quality mode. This set of codes is sent to the printer before
printing 4 through 30 generation pedigrees.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 26
Reset From Letter Quality Mode
If printer codes were not used to set letter quality mode then the
current input line should be cleared. Other printers will require a
sequence of characters to reset from letter quality mode.
Set Enhanced Character Mode
Some reports are printed with enhanced characters if possible. If the
printer is not capable of enhanced printing, the current input line
should be cleared. Other printers will require a sequence of
characters to set letter quality mode.
Reset From Enhanced Character Mode:
If printer codes were not used to set enhanced character mode then the
current input line should be cleared. Other printers will require a
sequence of characters to reset from letter quality mode.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 27
Install License Registration
The selection of Install License Registration will allow registered
users to unlock PEDIGREE to accept over 2 million animal records.
Prompts will be asked for the name of the license owner, the license
number and the 16 character key code that is included with the
license. Keep the written record of these three items safe, as they
will unlock all future upgrades to PEDIGREE as they are released.
1) Enter the Name of the license owner as shown on the
registration form.
2) Enter the License Number from the registration form.
3) Enter the Code Key from the registration form.
An incorrect entry will display an error message and wait for
corrections to the incorrect field. Simply try again and double check
each line before going on to the next entry.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 28
Supplemental Title Definition
The first step in changing breed Title Definitions is to fill in the
entire breed name for later use on reports. The question about
redefining the A.K.C. awards should be answered next. For United
States users who are working with American Kennel Club registered
dogs, this should be answered 'N'. Users from other countries or
those with dogs registered with other kennel clubs should answer 'Y'.
Answering 'N' here will atuomatically reset the first twelve awards
back to the A.K.C. standards. If the A.K.C. awards are not changed,
then sixteen additional titles may be defined for any awards desired.
The first twelve awards will follow the A.K.C. standards for
abbreviation and method of display. If the A.K.C. awards are changed,
then all 28 awards may be defined. Changing the A.K.C. awards also
replaces the eleven character AKC number field with a twenty character
REG number field. This is more flexible for international users.
Each title definition consists of a three parts. The formal title is
used on the Statistical Summary of the data file. An abbreviation of
the title will be reported with all references to an animal's name.
The position for the title will determine whether the title goes
BEFORE, AFTER, or UNDER the animal's name. Another possibility for
title position is NEVER, which will cause the title to be printed only
on the listing of the entire database. It would never be printed on a
pedigree or other report.
Some examples are:
Formal Title Abbreviation Position
Certificate of Gameness CG After
Register of Merit ROM After
Field Winner FW Before
When an animal's name is displayed, the first title defined will be
closest to the name, either before, after or under as defined.
Entry of data on animals with these titles will be done from the Add
New Data menu item.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 29
Color Setup
Color information may be set for the CRT to your personal taste. All
of the 16 foreground colors on 8 background colors may be used. The
color and monochrome attributes may be set for each type of text. If
the program detects a monochrome video adapter, or if the command line
contains a '/m' parameter, the monochrome attributes will be available
for modification. These attributes are selected from a color chart
for the foreground followed by the background. The current settings
are highlighted above the marker. The marker may be moved with the
<Cursor Left> and <Cursor Right> and the selection ended with
<Enter>.
Settings are required for the following types of text:
Normal text and entry prompts.
Entry fields which are not currently selected.
Highlighted text and the current entry field.
One line help message and error messages.
The screen border.
The trace number for data items.
The mouse cursor if a mouse is active.
If any of the settings are changed, the program will save the changes,
save all data, close the database and exit. This is necessary to
properly assign the new colors.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 30
Setup Country Information
There are three items which may be configured for local conventions.
The abbreviation for the domestic country name may be changed as
required. When foreign championships and domestic championships are
both entered for an animal, the abbreviation for each country will be
printed prior to the 'CH' with the name. The default is 'Am.' for use
in the United States. This may be changed to any 5 character
abbreviation desired.
The abbreviation for the name of the registering Kennel club may be
changed to any 8 characters desired. This will appear on various
reports and screens.
The third configurable item is the format for date display. The two
possibilities are 'mm/dd/yyyy' and 'dd/mm/yyyy' for both input and
output conventions. The date type display is selected with cursor
keys and the visible format accepted with the <Enter> key. This
change only affects the method of input and display for dates. There
are no changes to the way the data is stored internally. This means
that existing dates will not have to be changed to be displayed in the
new format.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 31
ERROR HANDLING
When an error occurs either in data file handling, or in keyboard data
entry, a message is displayed on the bottom line of the screen. The
message will be cleared and the program will continue after pressing
any key. Further help on most errors is available by pressing the
<F1> key. If the error is severe enough to cause the program to fail,
all files will be closed and data saved automatically where possible.
The importance of keeping back up data files cannot be overemphasized.
Non fatal errors will have no effect on the data files and are
summarized below:
Alias Is Not In Data File
The alias name being deleted is not in the alias file.
Animal And Parent Can't Have Same Name
The name being entered or revised would result in this animal having
the same name as one of it's parents or one of it's offspring. This
must be corrected by reentering a different animal name.
Animal Is Not In Database
Alias names may not be entered for an animal which has not yet been
added to the data file. Likewise, revisions may not be made without
first adding the animal to the data file nor may an animal that is not
in the data file be removed.
Animal Is Not Of This Sex
The animal being entered as a Sire or Dam is already in the data file
and has the wrong sex to be used in this situation. This must be
corrected by reentering a different animal name.
Animal Is Of Opposite Sex For Offspring Listed
The animal has offspring in the data file that show this animal to be
of the opposite sex. The entry must be deleted and then be reentered
to change the sex, or the offspring must be changed.
Can't Delete Animal's Name
An animal's name cannot be removed from the Revise function. To
remove an animal from the data file, use the Delete menu selection.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 32
Can't Replace Animal With Itself
Replacement animal for one being deleted is the same animal. One of
the entries is probably in the Alias file as another name for the
other one.
Conflicting Comment Data
Combining these two records would loose the comment fields on the
record being deleted. Write down the comment fields for both records
before proceeding. They may be entered again after combining the
records.
Conflicting Foreign Data
Combining these two records would loose some of the foreign titles for
the record being deleted. Write down the foreign titles for both
records before proceeding. They may be entered again after combining
the records.
Conflicting Record Data
These two records have conflicting data. The error codes are summed
up to the number shown:
512 = Differing Names 256 = Differing AKC Numbers
128 = Differing Sex 64 = Differing Birth Dates
32 = Differing Other Reg. # 16 = Differing Other Reg. Body
8 = Differing Sires 4 = Differing Dams
2 = Differing Stud Book Dates 1 = Differing Title Dates
Example: Error of 133 = 128 + 4 + 1 means records are different
in SEX and DAM NAMES and TITLE DATES.
Conflicting Supplement Data
These two records have conflicting supplemental data. The error codes
are summed up to the number shown:
64 = Differing Import Country 32 = Differing Original Reg.
16 = Differing Description 8 = Differing Breeder Name
4 = Differing Date of Death 2 = Differing Registration
1 = Differing Title Dates
Example: Error of 9 = 8 + 1 means records are different in BREEDER
NAME and TITLE DATES.
or: Error of 80 = 64 + 16 means records are different in
IMPORT COUNTRY and DESCRIPTION.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 33
Control Code Not Valid
This entry is not valid for a printer control code. Reenter.
Non-printable control codes are input as a back slash '\' followed by
a 3 digit decimal number only. For example, an ESCAPE code is entered
as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
Data File Was Made by Wrong Version
The sequential data files were created by a version of PEDIGREE that
does not format data in the same manner. The oldest version of
PEDIGREE that creates compatible files is Ver. 1.10. The solution to
this is to create new sequential files with this version of PEDIGREE.
Error in Writing Config File
There is an error in writing the configuration changes to the disk.
This is not a fatal error, but the new program configuration will not
be saved. Exit the program and determine if there is sufficient disk
space and available directory entries to create files. Confirm that
there is a statement 'FILES=20' or greater in the file CONFIG.SYS on
the boot disk or root directory.
Index Files Are In Error
There is an error in the index files which will interpret this entry
in an incorrect manner. Reindex the data file on all fields before
continuing to correct.
Name Can't Start with '#' Symbol
The name of an animal must not start with the '#' symbol, as this is
reserved for searching through existing animals by database entry
number.
Name Is Already In Alias File
The alias name has already been entered in the file as an alias for a
different animal.
Name Is Already In Data File - Delete First
The name being added as an alias or as a revised name to an existing
entry already exists in the data file. If this entry is correct, then
the existing animal must be deleted from the database first.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 34
Not A Valid Date
Separators for dates are: / - . or space
Inputs for birth date should be in the format which has been selected
from the 'Setup Domestic Country Information' menu item. The valid
formats are of a one or two digit month (or day,) a separator, a one
or two digit day (or month,) a separator, then the year.
The following are all acceptable examples:
05/03/87 5/3/1987 5-03-87 05,03,1987 5 3 8
Inputs for published dates should be in the format of a one or two
digit month, a separator, then the year.
The following are all acceptable examples:
05/87 5/87 05/1987 5-87 5,87 5 87 05 1987
00/87 00/1987 y yes
Not a Valid Directory Path
This is not a path to a valid directory. Either the directory does
not exist on the drive, or the disk is invalid. Enter a new path to
correct.
Not Enough Memory to Continue
There is insufficient memory to perform the requested action. This is
a fatal error, as the program is unable to perform a major function.
The program will automatically terminate after closing the data files
and saving the current status of requested operation. You must reduce
other memory requirements before trying again.
Only 300 Records Allowed Without Registering
You have reached the maximum number of records which may be entered
into a breed database with the shareware version. Please register
your copy of PEDIGREE to receive a code key which will unlock the
database for an unlimited number of animal entries.
Published Data Does Not Agree With Data File
The date of the Stud Book or AKC Gazette does not agree with existing
data in the file for this animal.
Sire And Dam Can't Have Same Name
The name being entered or revised would result in the sire and dam
having the same name. This must be corrected by reentering a
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 35
different animal name.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 36
DATA FILE MANAGEMENT
Reorganization of the database may become necessary if index files or
the data files have been corrupted through power outages or computer
errors. As these errors can occur at any time, it is very strongly
recommended that you keep back up copies of all data files at regular
intervals. The database is indexed on five separate fields for rapid
retrieval of information. If an error that causes the index files to
mismatch the data files occurs, reindexing of the index file will be
necessary.
File Reindexing:
The database is indexed on five separate fields for rapid retrieval of
information. If an error that causes the index files to mismatch the
data file occurs, reindexing of the index files will be necessary.
The menu selection for reorganizing the data file will allow the
selection of reindexing the data file.
File Verification:
The menu selection for data file verification will cross check the
animal records with supplemental records to make certain that they
contain the same data pointers. Some logical checking will also be
done to check the validity of the data file.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 37
APPENDIX A
Sequential File Structure
Sequential files are plain ASCII files with fields separated by a
comma and each entry is terminated with a carriage return and line
feed. If an entry contains a comma in a field, the field is
surrounded by quotation marks.
The structure of these files is as follows:
Breed.DA0 Breed setup file in the following order:
Line stating one of the following:
'Titles Are AKC Standard'
'Titles Are NOT AKC Standard'
28 lines in order of title appearance with animal name. Each
consisting of the following:
Title Abbreviation - maximum of 8 characters.
Name of Title - maximum of 35 characters.
Position of title printing .. A - after name
B - before name
U - under name
N - never print
3 lines containing title of Supplemental fields for registration
data, each is a maximum of 20 characters long.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 38
Breed.DA1 Main data in the following order:
Name - maximum of 50 characters.
Registration number - 11 characters if A.K.C. titles have not
been changed, otherwise 20 characters.
Sex - B D or space.
Birth date - yyyymmdd.
Sire Name - maximum of 50 characters.
Dam Name - maximum of 50 characters.
Date Published in Stud Book - packed form.
Championship Published - packed form.
Companion Dog Published - packed form.
Companion Dog Excellent Published - packed form.
Utility Dog Published - packed form.
Tracking Dog Published - packed form.
Tracking Dog Excellent Published - packed form.
Obedience Trial Championship Published - packed form.
Amateur Field Trial Championship Published - packed form.
Field Trial Championship Published - packed form.
Junior Hunter Published - packed form.
Senior Hunter Published - packed form.
Master Hunter Published - packed form.
User Defined Field #1 Published - packed form.
User Defined Field #2 Published - packed form.
Dual Registration Kennel Club - maximum of 8 characters.
Dual Registration number - maximum of 20 characters.
Packed form for published dates may be expanded to valid dates as
follows:
0 -- means that no published date exists in
file.
1 -- means that published date is known to
exist, but the date is not known.
other # -- add 188000 to the number. The right 2 digits are the
month and the left 4 digits are the year. If the
month is 00 then the year is known but the month is
not.
Breed.DA2 Alias names in the following order:
Actual name of animal in Breed.DA1 - 50 characters maximum.
Alias name of animal - 50 characters maximum.
Breed.DA3 Foreign Champions in the following order:
Actual name of animal in Breed.DA1 - 50 characters maximum.
Country of foreign championship - 5 characters maximum.
(repeated 25 times)
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 39
Breed.DA4 1st Supplemental Data in the following order:
Actual name of animal in Breed.DA1 - 50 characters maximum.
Country of import - 5 characters maximum.
Registration number in original country - 20 characters maximum.
Description of animal - 30 characters maximum.
Name of breeder - 30 characters maximum.
Date of Death - yyyymmdd.
Breed.DA5 2nd Supplemental Data in the following order:
Actual name of animal in Breed.DA1 - 50 characters maximum.
Clearance 1 data - 15 characters maximum.
Clearance 2 data - 15 characters maximum.
Clearance 3 data - 15 characters maximum.
User Defined Field #3 Published - packed form.
User Defined Field #4 Published - packed form.
User Defined Field #5 Published - packed form.
User Defined Field #6 Published - packed form.
User Defined Field #7 Published - packed form.
User Defined Field #8 Published - packed form.
User Defined Field #9 Published - packed form.
User Defined Field #10 Published - packed form.
User Defined Field #11 Published - packed form.
User Defined Field #12 Published - packed form.
User Defined Field #13 Published - packed form.
User Defined Field #14 Published - packed form.
User Defined Field #15 Published - packed form.
User Defined Field #16 Published - packed form.
Breed.DA6 Comment data in the following order:
Actual name of animal in Breed.DA1 - 50 characters maximum.
First comment line - 50 characters maximum.
Second comment line - 50 characters maximum.
Breed.DA7 Notes data in the following order:
Up to 15 lines for each animal, each consisting of:
Actual name of animal in Breed.DA1 - 50 characters maximum.
Line from notes entry - 65 characters maximum.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 40
APPENDIX B
Upgrading From Previous Versions
The process of upgrading your data files to the current version of
PEDIGREE requires that you have at least 2 1/2 times as much free disk
space as the total of the sizes of your breed.PEn files. This space
will be used temporarily in the upgrade process. Please note that
part of the upgrade process should be performed before installing the
new version of PEDIGREE.
Upgrading from PEDIGREE
ver. 1.xx to current ver.
<<<<< The first step is very important!!!! >>>>>
1) Make a backup of your 'breed.PE*' and 'PEDIGREE.*' files.
2) Copy the program 'PED1SEQ.EXE' to the directory where your data
files exist.
3) Run 'PED1SEQ' and input the breed name when asked. Input the name
of a valid path for the location of the sequential files. This
may be just an <ENTER> to put the files in the current directory.
4) Delete the files 'PEDIGREE.*' and 'breed.PE*' from your hard disk.
5) Install the new program by typing d:INSTALL where d is the floppy
disk letter. This will un-archive the new program, help file and
documentation.
6) Run 'PEDIGREE' and configure the new version. Use Sequential File
Input to read in the 'breed.DA*' files which you created in step
3.
7) When you exit 'PEDIGREE', delete the following files from the
hard disk:
breed.DA0 breed.DA1 breed.DA2 breed.DA3 breed.DA4
breed.DA5 breed.DA6 PED1SEQ.EXE PED1SEQ.DOC
This completes the upgrade to the newest version of PEDIGREE.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 41
Upgrading from PEDIGREE
ver. 2.xx to current ver.
<<<<< The first step is very important!!!! >>>>>
1) Make a backup of your 'breed.P*' and 'PEDIGREE.*' files.
2) Run your old version of PEDIGREE and select the 'Add or Revise'
Menu item. Select the 'Sequential File Processing' Menu item.
Select 'Write Sequential Files' Menu item. Input the name of a
valid path for the location of the sequential files. This may be
just an <ENTER> to put the files in the current directory.
3) Delete the files 'PEDIGREE.*' and 'breed.P*' from your hard disk.
4) Install the new program by typing d:INSTALL where d is the floppy
disk letter. This will un-archive the new program, help file and
documentation.
5) Run 'PEDIGREE' and configure the new version. Use Sequential File
Input to read in the 'breed.DA*' files which you created in step
2.
6) When you exit 'PEDIGREE', delete the following files from the hard
disk:
breed.DA0 breed.DA1 breed.DA2 breed.DA3 breed.DA4
breed.DA5 breed.DA6
This completes the upgrade to the newest version of PEDIGREE.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 42
APPENDIX C
DOS Input/Output Error Messages
DOS Input and Output processes may refer to the following errors by
number from the error message 'I/O error: ' and the error number:
2 : File not found
3 : Path not found
4 : Too many open files
5 : File access denied
6 : Invalid file handle
8 : Not enough memory
10 : Invalid environment
11 : Invalid format
12 : invalid file access code
15 : Invalid drive number
16 : Cannot remove current directory
17 : Cannot rename across drives
18 : No more files
100 : Disk read error
101 : Disk write error
102 : File not assigned
103 : File not open
104 : File not open for input
105 : File not open for output
106 : Invalid numeric format
150 : Disk is Write Protected
151 : Unknown disk unit
152 : Drive is not ready
153 : Unknown command
154 : CRD error in data
155 : Bad request structure length
156 : Disk Seek error
157 : Unknown media type
158 : Disk sector not found
159 : Printer out of paper
160 : Device write fault
161 : Device read fault
162 : Hardware failure
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 43
LICENSE AGREEMENT
Terms and Conditions of Use:
All versions of PEDIGREE by Charles H. Orange are not public domain
software, nor are they free software.
Non-registered users are granted a limited license to use PEDIGREE on
a trial basis only for the purpose of determining it's suitability for
their needs. Use of PEDIGREE except for this limited purpose requires
registration. Non-registered versions of PEDIGREE are limited to only
300 animal entries.
Registration permits a user the license to use PEDIGREE on a single
computer; a registered user may use the program on a different
computer, but may not use the program on more than one computer at the
same time. Registered versions of PEDIGREE support over 2 million
animal entries.
Terms and Conditions of Copying:
All users are granted a limited license to copy the non-registered
version of PEDIGREE for the purpose of archive or backup protection as
well as for the trial use by others subject to the above limitations
and to the following restrictions:
Non-registered versions of PEDIGREE must be distributed in unmodified
form, complete with the help and text files with this license
information.
No fee or charge may be made by anyone beyond the reasonable cost of
duplication and media.
Non-registered versions of PEDIGREE may be distributed in an archived
format by operators of electronic bulletin boards if they observe the
previous conditions.
Versions of PEDIGREE with the license and Code Key installed may not
be copied except for the purpose of archive or backup protection.
PEDIGREE (c) 1988-1995 Charles H. Orange Page: 44
ORDER FORM
To register your copy of PEDIGREE, please fill in the information
below and send with $40.00 to:
Charles H. Orange
P.O. Box 20
Downers Grove, IL. 60515
Name _________________________________________ Circle Disk Size
Address ______________________________________ 3 1/2" 5 1/4"
______________________________________
City ____________________________ State _____ Zip __________
Registered users will receive the latest version on disk as well as
announcements of future upgrades and additional products as available.
The following is optional and for my information only.
Breed _________________________ Kennel Name _________________________
Please check here if I may give your name to other users in your breed
for the purpose of exchanging data files. _____(YES) _____(NO)
ACCESSING THE HELP SYSTEM, 7
Add New Entries To Database, 14
ADD or REVISE DATA, 14
AKC NUMBER, 9
Alias Is Not In Data File, 32
ALIAS NAME, 9
Animal And Parent Can't Have Same Name, 32
Animal Is Not In Database, 32
Animal Is Not Of This Sex, 32
Animal Is Of Opposite Sex For Offspring Listed, 32
ANIMAL REGISTERED NAME, 9
ANIMAL'S SEX, 9
BIRTH DATE, 9
BREED NAME, 9
BREEDER NAME, 10
Can't Delete Animal's Name, 32
Can't Replace Animal With Itself, 33
Color Setup, 30
COMMENT, 10
Conflicting Comment Data, 33
Conflicting Foreign Data, 33
Conflicting Record Data, 33
Conflicting Supplement Data, 33
Control Code Not Valid, 34
CONVENTIONS FOR INPUT, 7
COUNTRY NAMES, 10
Create Pedigree, 18
DATA FILE MANAGEMENT, 37
Data File Was Made by Wrong Version, 34
DATA RELIABILITY, 12
DATE OF DEATH, 9
Delete An Entry, 16
Descendant List, 20
DESCRIPTION, 12
DETAILED MENU ITEMS, 14
DOS Input/Output Error Messages, 43
Enter Alias Name Data, 16
Enter Foreign Champion Data, 15
ERROR HANDLING, 32
Error in Writing Config File, 34
FILE PATH, 12
File Reindexing, 37
File Verification, 37
Find Comment Text, 22
GENERATE REPORTS, 18
GETTING STARTED, 3
Index Files Are In Error, 34
PEDIGREE (c) 1988-1995 Charles H. Orange
INPUT FIELDS, 8
Install License Registration, 28
INTRODUCTION, 1
KENNEL NAME, 12
KEYBOARD ENTRY EDITING, 8
LICENSE AGREEMENT, 44
Line Breeding List, 19
List Data File, 21
List Names In Alphabetical Order, 21
MOUSE USAGE, 7
Name Can't Start with '#' Symbol, 34
Name Is Already In Alias File, 34
Name Is Already In Data File - Delete First, 34
Not A Valid Date, 35
Not a Valid Directory Path, 35
Not Enough Memory to Continue, 35
NOTE FIELDS, 12
NUMERICAL INPUT, 12
Only 300 Records Allowed Without Registering, 35
ORDER FORM, 45
OVERVIEW, 2
Printer Setup, 24
PROGRAM INSTALLATION, 3
Published Data Does Not Agree With Data File, 35
PUBLISHED DATE - Animal, 13
PUBLISHED DATE - Title, 13
REGISTRATION NUMBER, 13
Reorganize Data File, 16
Revise An Entry, 15
RUNNING PEDIGREE, 7
Search for Breeder Name, 22
Search for Kennel Name, 21
Search for Medical Clearance, 23
Search for Titles Awarded, 22
SELECTING MENU ITEMS, 7
Sequential File Processing, 16
Sequential File Structure, 38
Setup Country Information, 31
SETUP PROGRAM INFORMATION, 24
Sire And Dam Can't Have Same Name, 35
Statistical Summary, 21
Supplemental Title Definition, 29
SYSTEM REQUIREMENTS, 3
TITLE ABBREVIATIONS, 13
TITLE DEFINITIONS, 13
PEDIGREE (c) 1988-1995 Charles H. Orange
Top Producing List, 20
Upgrading From Previous Versions, 41
PEDIGREE (c) 1988-1995 Charles H. Orange